1/2 


1 1  Ro-Mti  n? 

UNCLASSIFIED 


INTEGRATED  1NFOAAATION  SUPPORT  SVSTEN  (IISS)  VOLUME  3 
COMMON  DATA  MODEL  S.  .  <U>  GENERAL  ELECTRIC  CO 
SCHENECTADV  NV  PRODUCTION  RESOURCES  CONSU.  . 

J  L  ALTHOFF  ET  AL.  01  NOV  83  PS-620141208  F/G  12/3 


NL 


* 


AD-A181  957 


flTB  ALE  COP' 


AFWAL-TR-86-4006 
Voluae  V 
Part  10 


IRTEGRATXD  INFORMATION 
SUPPORT  SYSTEM  (ZISS) 

VoIum  V  -  Common  Data  Modal  Subsysten 
Fart  10  -  HDKL  Preconpiler  Control  Modula 
Product  Specification 


Gaaaral  Elactric  Coapany 
Production  Resources  Consulting 
Ona  Rivar  Road 
Scheaeetady ,  Raw  York  12345 


Final  Raport  for  Period  22  Saptaabar  1980  -  31  July  1985 
Roveaber  1985 


Approved  for  public  release;  distribution  is  uni  ini  ted. 


PREPARED  FOR: 

MATERIALS  LABORATORY  , 

AIR  FORCE  WRIGHT  AERONAUTICAL  LABORATORIES 

AIR  FORCE  SYSTEMS  COMMAND 

WRIGHT -PATTERSON  AFB.  OH  45433-6533 


87  7  2  0*0 


NOTICE 


When  Government  drawings,  specifications,  or  other  data  are  used  for  any  purpose  other  than 
mi  connection  with  a  definitely  related  Government  procurement  operation,  the  United  States 
Government  thereby  incurs  no  responsibility  nor  any  obligation  whatsoever;  and  the  tact  that  the 
government  may  have  formulated,  furnished,  or  in  any  way  supplied  the  said  drawings, 
specifications,  or  other  data,  is  not  to  be  regarded  by  implication  or  otherwise  as  in  any 
manner  licensing  the  holder  or  any  other  person  or  corporation,  or  conveying  any  rights  or 
permission  to  manufacture,  use,  or  sell  any  patented  invention  that  may  in  any  way  be  related 
thereto. 

This  report  has  been  reviewed  by  the  Office  of  Public  Affairs  (ASD/PA)  and  is  releasable  to  the 
National  Technical  Information  Service  (NTIS).  At  NTIS.  it  will  be  available  to  the  general 
public,  including  foreign  nations. 


This  technical  report/ has  been  reviewed  and  is  approved  for  publication. 


DAVID  L/JUDtON/  PROJECT  MANAGER 
AFWAUMU 

VGHT  PATTERSON  AFB  OH  45433 


DATE 


fjjjL 


FOR  THE  COMMANDER: 


.. —  ?c=^  C. '  — 

-Gerald  c.  shumaker,  branch  chief 
AFWAUMLTC 

WRIGHT  PATTERSON  AFB  OH  45433 


DATE 


'J  /<£> 


"If  your  address  has  changed,  if,  you  wish  to  be  removed  from  our  mailing  list,  or  if  the 
addressee  is  no  longer  employed  by  your  organization  please  notify  AFWAUMLTC,  W-PAFB,  OH 
45433  to  help  us  maintain  a  current  mailing  list.0 

Copies  of  this  repon  should  not  be  returned  unless  return  is  required  by  security  consideration * 
contractual  obligations,  or  notice  on  a  specific  document 


iieut'f*  cl«u  ••eAtio*.  ©»  t«it  *»8i 


1  November  1985 


I  MCwM'Tt  CkAtti”CATlON 

Daeltiiifiad 


REPORT  DOCUMENTATION  PAGE 


I*  IICWtiTv  CkASSif  iCATiON  AWTNOAlf  V 


a»  MCk*et<#iCATiew/oe«*«asMAeiwe  tc»ieuu 


•a  KAMI  o*  MAIOAWINC  0*6ANltATl©N 

6nml  electric  Coapuy 
Production  Resources  Consul t Inf 


•c  AOOKtSS  (Cir».  Iw  ms  U*  CmStt 

1  River  Rood 
Rebenectsdy,  RT  >8948 


••  mahi  o*  ouMOiwo/oroosooiNa 

e*SAUl|ATlON 
Muter lulu  Laboratory 
Atr  Foroo  lyiltn  Co— and.  WAT 


St  ADOSISI  iCifi.  S««  —  ttf  CMM 

Vrifht-Pettersoe  APR.  Okie  45499 


U  OSSt AiCtlvS  MASKING* 


a  O'SToitwtiow.AvA.LAtikiT*  or  ntroet 

Approved  for  public  rolooso; 
distribution  Is  unlioltod. 


S.  Meuitemwc  o*CaniCaTion  nt»©*T  wwMSioisi 
ArVAL-TR-M-4006  Vol  V.  Port  10 


to.  NAUIO*  MONlTOAlNC  ORGANISATION 

ATVAL/KLTC 


to  ASBMU  rCtfr.SMo  ms  t»  Cssti 
VP APB,  OB  45488-0599 


I.  MeeUllMINT  INSTRUMtNt  IDUiTiAiCATiON  NUMBS* 
P9961 5-80-C-5195 


10  SOURCS  Of  SWMOINC  NOS 


in/>  i’""' '"""i 


i»*c,  CuiiriiN* 

(See  Reverse) 


18  NRIOMAi  autmoribi 

Altboff.  J.  I».  end  Apioelle.  If.  L. 


i9«  T»»i  os  nsroet  I  iu  Tims  covonio 

rtaal  TmUIcaI  —port  I  U  Sept  1SS0  -  SI  duly  IMS 


w  iwNkiuiNTAii  uoiation  The  ooeputor  softvere  oontolned  herein  ere  theoretics!  end/or 

.  ,  .  .  ....  references  tbet  is  no  my  reflect  Air  Force-owned  or  -developed 

SCAM  Project  Priority  6901  OOBputar  BOftvsre. 


snoonAM 

CkCMCNTNO. 

ESES 

TACK 

MO. 

woes  unit 
NO. 

TC011P 

7500 

62  . 

01 

10.  OATS  Or  RtrORT  IY'..  Mm.  Dmr> 
IMS  Soveaber 


it  SAM  COUNT 
122 


COSATI  cooes 


■  Owe 


ooeputor  soft were. 


mSUSAtCT  TBRMS  (Cease «•  ea  ear—  fwweeq  see  «NaS li  Sr  Star* 


is  eesteect  iCwww  ea  i 


i  ifmnmun  mS  aSrasfr  S»  Star*  wnNfi 


■9  This  document  is  the  product  specification  establishing  the  design 
implementation  of  the'llSS  Configuration  Item  PREO  which  will 
control  other  components  of  the  Neutral  Data  Manipulation 
Language  (NDML)  precompiler.  - - . 

'  rt  i  ■  / 


so  0iSTSiewtiON>AvAikASitiTT  or  amtoact 
UNCkASSlSltO/WNUMlTSO  V  SAMS  At  OST.  C  OTIC  UStRS  □ 


SSa  NAMt  O*  Attao— Itkt  iNDiviOWAk 

Oevid  L.  dud son 


DO  FORM  1473.  S3  APR  coition  or  i  aan 


SSTRACT  St  CU  A  ITT  CkAttK  (CATION 

Onclessif led 


Ua  tSlS»«*©ni  numbs* 


915-955-0076 


coition  or  i  aan  n  «  omouCtc. 


ssi  omes  tTwsok 

atval/rltc 


_ Onclsstlf led 

MCweiTt  CkASSiriCATiON  O*  Tat  »A0t 


11.  Title 


Integrated  Information  Support  System  CUSS)  • 

Vol  V  -  Couon  Data  Model  Subsystem 
Part  10  -  MDML  Precompiler  Control  Module  Product 
Specification 


Accesion  For 

r~ 

NTIS  CRA&I  fi 

OTIC  TAB  C 

U-.aniiO.:  wtid  C 

Justification 

l 

] 

) 

By 

Distribution/ 

Availability  Codes 

Dist 

£L 

Avail  c 
Spe 

ind/or 

cial 

PS  020141200 
1  November  1065 


FjgACT 


This  produot  specif i cat Ion  oovers  the  work  performed  under 
Air  Force  Contract  F3S61S-80-C-S18B  (XCAM  Projeot  6201).  This 
contrmot  is  sponsored  by  the  lister  inis  Laboratory .  Air  Poroe 
Systems  Command ,  Wright -Pat ter son  Air  Foroe  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  XCAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson .  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  Mew  York,  under  the  direction  of 
Mr.  Alan  Rubens tein.  The  General  Electric  Projeot  Manager  was 
Mr.  Myron  Hurl but  of  Industrial  Autonation  Systems  Department, 
Albany.  Mew  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projeots  have  been  integrated  under  Projeot  .6201 
for  publication  and  treatment  as  an  integrated  set  of  doo^iMhts. 
The  particular  contributors  to  each  dooument  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  dooument  FTR620100001 ,  Projeot  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 


Subcontractors 

Boeing  Military  Aircraft 
Company  (BHAC) 

D.  Appleton  Company 
CDAOOM) 


General  Dynamios/ 
Ft.  Worth 


Role 

Reviewer 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
models 
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iibowitrMiari 

ZUlMll  Institute  of 
Technology 


North  Amor loan  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTooh 


Nolo 

Responsible  for  faotory  view 
function  research  (IXTNX) 
and  information  models  of 
small  and  median- si so  business 

Reviewer 

Responsible  for  faotory  view 
function  amd  information 

models 

Responsible  for  IDEF3  support 
Responsible  for  IDEFO  support 


TANK!  4.6  -  4.9  (TEST  NIP) 

Subcontractors 

Noe inf  Military  Airoraft 
Company  (RMAC) 


Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
(GDC) 


D.  Appleton  Company 
(DAOOH) 


Role 

Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  oonputer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DAOOM ) . 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DAOOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractor* 

Digital  Kquipnent 
Corporation  (DEC) 


MoDonnol 1  Douglas 
Autonation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Role 

Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Ret work 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
beoame  McCormack  9  Dodge) 


SofTeoh ,  Ino . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  paokage  (PIOS)  that 
they  suppl ied. 

Responsible  for  the  design  and 
implementation  of  the  Metwork 
Transaction  Manager  (RTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Prime  contractors  under  other  projeots  who  have  contributed 
to  Test  Bed  Technology,  their  contributing  activities  and 
responsible  projects  are  as  follows: 


Contractors 


I CAM  Project  Contributing  Activities 


Boeing  Military 
Airoraft  Company 
(BMAC) 


1701 ,  2201 .  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( ISMC) 


v 
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Contractors 

I CAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502. 

1701 

IISS  enhancements  to 
Coaaon  Data  Model 
Processor  (CDMP) 

D.  Appleton  Conpany 
CDACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  coanuni oat ions 
equipment . 

Hughes  Aircraft 

Conpany  (HAC) 

1701 

Test  Bed  enhancements 

Structural  Dynanios 
Resear oh  Corporation 

(sxmc) 

1502, 

1705 

1701. 

IISS  enhancements  to 
User  Interface/ Virtual 
Terminal  Interface 
(DI/VTI) 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 

vi 
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SECTIOM  1 
tOOPI 


1.1  Identification 

^  This  specification  establishes  the  dMifn  of  a  number  of 
software  modules  necessary  for  lha  precompiler  that  war*  not 
addraasad  1b  any  of  tha  HTML  Precompiler  Development 
tpaoif ioatioa.  Thay  oaa  ba  rafarrad  to  as  PREO . ^MDKL  Coatrol 
Modules**.  to  ba  built  aad  formal  ly  aooaptad  by  tha  I  CAM  Program 
Offioa.  This  Cl  ooBStitutas  09a  of  tha  subsystams  of  tha  Common 
B*^*?*?1  Processor  (CDMP).  ^  y 

¥■ '  1  -v 


^  pp~  r*/  _ 

2  Functional 


This  configuration  itaa  consists  of  tha  following  software 
modules : 

1 .  GDN01 .  API AMI 

2.  MAIM.  CDPRI 

3.  CDECHK 

4.  RPTERR 


5.  CDP13 

Tha  purpose  of  Computer  Program  Configuration  Item  (CPCI) 

%  brief  description  of  tha  major  functions  follows: 

1.  CDM01  is  designated  to  ba  a  queue  server  process  that 
accesses  an  ORACLE  database.  It  is  accessed  by  a  call 
to  the  module  APMAME .  It  determines  the  next  available 
name  to  use  for  a  software  module  that  is  to  be 
generated.  It  is  also  accessed  by  a  call  to  module 
RUMOD  to  signal  reuse  of  a  software  module  during  error 
recovery . 

2.  MAIM  and  CDPRI  are  designed  to  be  the  user  interface 
entry  point  and  top  level  NDML  precompiler  control 
module  respectively.  At  this  time,  the  user  interface 
is  the  MDML  precompiler  and  is  designed  to  be  a  simple 
batch -oriented  COBOL  program.  The  inputs  to  the 
precompiler  are  “ACCEPTED”  from  a  single  file  and  the 
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outputs  (the  identification  of  generated  code)  are 
"DISPLAY"  output.  This  user  interface  main,  after 
having  assembled  the  input,  then  calls  CDPRE .  CDPRE  is 
the  callable  entry  point  to  the  precompiler  itself. 

The  precompiler  has  been  made  a  callable  routine  to 
support  many  other  user  interfaces  as  yet  unbuilt. 

CDPRE  is  essentially  a  control  routine  of  other 
designed  CPCI ' s  of  the  NDML  precompiler.  It  executes  a 
loop  while  over  the  user  input  file.  This  allows  for 
many  user  nodules  of  a  single  logical  unit  of  work  to 
be  precompiled  at  the  same  tine  (a  requirement  of  the 
current  design).  After  each  user  module  is 
precompiled,  CDECHK  is  called  to  perform  any  error 
handling  chores.  At  the  end  of  the  user's  batch,  CDP14 
(PRE14)  is  accessed  to  generate  the  necessary  request 
processor  main  routines. 

S.  CDECHK  is  a  nodule  that  localizes  all  error  checking 
and  handling  for  the  precompilation  of  a  single  user 
module.  If  the  precompile  was  successful,  a  record  of 
all  generated  code  is  stored  on  the  CDM  ORACLE 
database.  If  unsuccessful,  all  nodule  names  assigned 
and  generated  during  the  precompi lation  process  must  be 
marked  as  re-useable. 

4.  A  generalized  routine,  RPTERR ,  is  used  to  report  user 
errors  during  precompilation.  This  writes  the  specific 
message  into  an  error  file  that  contains  all  user  input 
code  along  with  the  interspersed  error  messages  in  much 
the  same  way  as  a  standard  COBOL  compiler. 

5.  CDP13  is  a  nodule  designed  to  control  all  code 
generation  activities  of  the  precompiler.  It  is  called 
by  PRE5.  Input  to  CDP13  consists  of  the  logical 
specifications  for  each  subtransaction  to  be  generated. 
Por  each  subtransaction,  APNAME  is  called  to  get  a  new 
name  for  the  module  to  be  generated  for  a  query,  PRE8 
is  called  to  generate  the  CS  to  ES  transformer.  PRE10 
is  called  to  generate  code  into  the  user's  AP.  Also, 
one  of  the  DBMS  specific  code  generator's  is  called 
based  upon  the  type  of  DBMS  the  subtransaction  must 
access . 


1-2 
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SECTIOH  2 
DOCUMENTS 


2.1  Reference  Documents 

1 .  ICAM  Docuaentat 1 on  Standards :  IDS15012000A ,  28 

December  1981. 

2.  D.  Appleton  Co.,  CDM  Administrators  Manual: 

PM620141000,  March  1984. 

S.  D.  Appleton  Co.,  CDM1-XDEF1  Model  of  the  Common  Data 
Model ;  CCS620141000.  15  May  1985. 

4.  D.  Appleton  Co.,  Computer  Program  Development 
Specification  (PS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDML  Precompiler; 
DS620141200 ,  October  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer  *  s  Reference 
Manual;  PRM620141200.  March  1985. 

6.  Softech,  Inc.,  NTM  Programmer  *  s  Guide:  PM620140001 . 
July  1984. 

7.  Control  Data  Corp.,  Computer  Program  Development 
Specification  (PS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  KDDL  Command  Processor; 
DS620141100,  June  1985. 

2.2  Terms  and  Abbreviations 
Attribute  Use  Class:  (AUC) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor:  (CDMP) 

Common  Data  Model:  (CDM)  Describes  common  data  application 
process  formats,  fora  definitions,  etc,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transf oraat i on  operators . 

Data  Field:  (DF)  An  element  of  data  in  the  external  schema.  It 
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Is  by  this  mum  that  aa  HDHL  programmer  references  data. 
Database  Management  System:  (DBMS) 

Distributed  Request  Supervisor:  (DBS)  This  IISS  CDM  subsysten 
configuration  i tea  oontrols  the  exeontlon  of  distributed  MDML 
queries  and  non  distributed  updates. 

Domain:  A  logical  definition  of  legal  attribute  class  values. 
Domain  Constraint:  Predicate  that  applies  to  a  single  domain. 
External  Schema:  (ES) 


Forms :  Structured  views  which  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields  where  each  field  is  a 
fora,  item,  or  window. 


Forms  Processor:  (FP)  A  set  of  callable  execution  time  routines 
available  to  an  application  program  for  fora  processing. 

Internal  Schema:  (18) 

Integrated  Information  Support  System:  (IISS)  A  test  computing 
environment  used  to  investigate,  demonstrate  and  test  the 
concepts  of  information  management  and  information  integration 
in  the  context  of  Aerospace  Manufacturing.  The  IISS  addresses 
the  problems  of  integration  of  data  resident  on  heterogeneous 
databases  supported  by  heterogeneous  computers  interconnected 
via  a  local  Area  Metwork. 


Mapping:  The  correspondence  of  independent  objects  in  two 
schemas:  E8  to  C8  or  CS  to  IS. 


network  Transaction  Manager:  (STM)  Performs  the  coordination, 
communication  and  housekeeping  functions  required  to  integrate 
the  application  processes  and  systen  services  resident  on  the 
various  hosts  into  a  cohesive  system. 

Meutral  Data  Manipulation  Language:  (VDML)  A  language  developed 
by  the  IIS8  project  to  provide  uniform  access  to  common  data, 
regardless  of  database  manager  or  distribution  criteria.  It 
provides  distributed  retrieved  and  single  node  updates. 

ORACLE:  Relational  DBMS  based  on  the  SQL  (Structured  Query 
Language,  a  product  of  ORACLE  Corp.  Menlo  Park,  CA)  The  CDM  is 
an  ORACLE  database. 
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Parcel :  A  sequential  file  containing  sections  source  code  of 
the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy  a 
retrieval  or  update  MDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface:  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface:  (VTI)  Performs  the  interfacing 
between  different  terminals  and  the  UI .  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  Definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules 
written  for  each  type  of  real  terminal  supported. 
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SECTION  3 
REQUIREMENTS 


3.1  Structural  Description 

A  graphic  portrayal  of  this  CPCI  is  included  in  Seotion 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI.  Since  only  those  modules  of  this 
CPCI  are  shown  in  Section  3.10,  the  user  is  referred  to  the 
diagrams  of  Section  3.3  to  show  how  these  modules  control  the 
CPCI's  of  the  NDML  precompiler. 

3.2  Functional  Flow 

A  single  execution  of  the  NDML  precompiler  may  have  many 
logical  units  of  work,  each  consisting  of  a  batch  of  user 
modules.  MAIN  controls  this  loop.  Each  batch  consists  of  many 
user  modules  which  may  be  precompiled  successfully  or 
unsuccessfully.  This  loop  is  controlled  by  CDPRE .  Error 
handling  logic,  for  each  user  module,  is  controlled  by  CDECHK. 
Many  NDML  statements  may  be  found  in  each  U6er  module.  This 
logic  is  controlled  by  PRE2 .  Each  NDML  statement  may  require 
many  conceptual  transactions  (the  original  request  plus  any 
integrity  tests)  which  is  controlled  by  PRE4 .  Each  conceptual 
transaction  may  require  many  internal  schema  subtransactions. 
This  is  determined  by  PRES.  The  generation  of  code  for  each 
subtransaction  is  controlled  by  CDP13. 

3.3  Interfaces 


Figure  3-1  depicts  the  interface  of  PREO  with  other  CPCI's 
in  the  system. 
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5.3.1  Inputs /Outputs 

The  following  tables  depict  the  inputs  and  outputs  of  each 
module  in  this  CPCI.  A  detailed  description  for  each  item  can 
be  found  in  the  DS  for  this  CPCI. 

NOODLE:  CDM01 

IMPPT  _  OUTPUT 


— NONE — 


MODULE:  APNAME 

INPUT _ OUTPUT _ 

DBMS  Name  Application  Process 

Name 

Module  Status 

MODULE:  CDPRE 

INPUT _  OUTPUT 


Application  Process  Input  File 
Error  File 

Application  Process  Target  Host 
Users  Application  Process  Name 


Code  Generator  Table 
Number  of  Good 
Precompiles 
Number  of  Bad 
Precompiles 
Module  Status 


MODULE:  CDECHX 

INPUT _ OUTPUT 


Precompile  Status  Module  Status 

Last  Module  Used 

Users  Module  Name 

Current  Host 

Target  Host 

Parcel  1 

Parcel  2 

Parce 1  3 
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Parotl  4 
8ouroe  Language 
Code  Generator 
Oracle  Logon  Data  Area 


5.4  Program  Interrupts 

Mot  applicable  to  this  CPCI . 

3.5  Timing  and  Sequencing  Description 
Mot  applicable  to  this  CPCI. 

3.6  Special  Control  Features 
Mot  applicable  to  this  CPCI. 

3.7  Storage  Allocation 

3.7.1  Database  Definition 

The  database  used  by  this  CPCI  is  the  Coeeon  Data  Model 
(CDH)  database.  This  aodel  is  defined  by  the  CDM1 ,  the  IDEFl 
nodel  of  the  CDH,  Reference  Muaber  3. 

3. 7. 1.1  File  Description 

Mo  permanent  files  have  been  defined  for  this  CPCI.  It  nay 
use  temporary  scratch  files  for  such  things  as  generated  program 
source  code  or  temporary  query  results. 

3. 7. 1.2  Table  Description 

Mot  applicable  to  this  CPCI. 

3. 7. 1.3  Item  Description 

Mot  applicable  to  this  CPCI. 

3.8  Object  Code  Creation 

The  object  oode  for  this  CPCI  will  be  created  by  the  system 
integration  test  team  by  using  defined  IISS  Software 
Configuration  Management  Procedures.  This  CPCI  will  use  the 
COBOL  language  compiler. 
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3.9  Adaptation  Data 

This  CPC I  has  been  coded  using  ANSI  COBOL.  The  intent  was 
to  provide  a  transportable  system.  Any  system  environment 
supporting  this  language,  a  virtual  memory  management  scheme, 
the  COMM  and  NTH  subsystem  of  IX8S  and  the  ORACLE  Database 
Management  System  should  be  able  to  support  this  CPCI.  Every 
possible  attempt  has  been  made  to  localise  and  identify  any 
machine  or  environment  dependent  modules  through  the  original 
design  of  the  IISS  and  application  of  Configuration  Management 
Procedures . 

3. 10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 

3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs”  which 
are  nodules  that  are  not  called  by  any  other  nodule  being 
documented  here.  These  modules  are  either  program  entry  points 
or.  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program.  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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Module 

CDM01 

CDP13 

MAIN 

OPNFIL 

STRMOV 

SUBMOV 


PRECOMPILER  CONTROL  Main  Program  List 
Name  Purpose 

CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 
CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
PROGRAM  NAME  NDML  MAIN  AND  UI 

THIS  ROUTINE  OPENS  AN  OUTPUT  FILE. 

MOVE  THE  STRING  TO  THE  POOL 
FACILITATE  A  SUB-STRING  MOVE 


PS  620141200 
1  November  1985 


3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 
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Module 

APMAME 

CDDGAP 

CDECHK 
CD I GAP 

CDM01 

CDP13 

CDPRE 

MAIM 

OPMFIL 

RCMOD 

RPTERR 

RUMOD 

STRMOV 

SOBMOV 


PRECOMPILER  CONTROL  Module  List 
Marne  Purpose 


INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

PROVIDE  PRECOMPILER  ERROR  CHECKING 

CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 

CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 

PROGRAM  NAME  NDML  MAIN  AND  UI 

THIS  ROUTINE  OPENS  AN  OUTPUT  FILE. 

MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 
REUSABLE 

OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP 
LISTING 

SIGNAL  REUSE  OF  A  MODULE 

ft 

MOVE  THE  STRING  TO  THE  POOL 
FACILITATE  A  SUB-STRING  MOVE 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  ail  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 
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PRECOMPILER  CONTROL  External  Routines  List 


Module  Name 

First  User 

CDFUNC 

APNAME 

CDP10 

CDP13 

CDP12 

CDPRE 

CDP14 

CDPRE 

CDPRE1 

CDPRE 

CDPRE2 

CDPRE 

CDPRE7 

CDP13 

CDPRE8 

CDP13 

CDPRE9 

CDP13 

CDQPC 

CDP13 

CDQPO 

CDP13 

CDQPT 

CDP13 

CLSERR 

CDPRE 

DELFIL 

CDECHK 

ERRPRO 

APNAME 

POPEN 

OPNFIL 

INITAL 

CDM01 

INITEX 

MAIN 

NSEND 

APNAME 

OBINDN 

CDIGAP 

OCLOSE 

CDIGAP 

OCOM 

CDM01 

ODFINN 

CDM01 

OEXEC 

CDDGAP 

OFETCH 

CDM01 

OLOGOF 

CDM01 

OLON 

CDPRE 

OOPEN 

CDDGAP 

OPNERR 

CDPRE 

OPNINPT 

CDPRE 

OROL 

CDPRE 

OSQL3 

CDDGAP 

PRINTF 

OPNFIL 

QSEND 

CDM01 

RCV 

CDM01 

REDINPT 

CDPRE 

TRMNAT 

CDM01 

UNPLINE 

CDPRE 

WRITER* 

CDPRE 

PS  620141200 
1  November  1985 


3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  nodules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  coaplete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "••••  PURPOSE  NOT  FOUND  BY  STRIPPER  ****“ 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  aost  coupon  reason  for  this  is  that 
the  include  file  cones  fron  system  libraries  that  were  not 
developed  by  the  project,  suoh  as  'C'  libraries  that  are 
provided  with  the  'C*  conpiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  nodules  which  call  in  each  of  these  include  files. 
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PRECOMPILER  CONTROL  Include  File  List 


File  Name 


Purpose 


ALFABET 

APAT 

APGC 

APINFO 

APL 

APRX 

CEWORK 

GGTABLE 

CHKCDM 

CSAL 

CSQUAL 

ERRCDM 

ERRPRO 

ESAL 

ESQUAL 

FILSTAT 

I  SAL 

ISQOAL 

JQGTBL 

ORCLEDA 

RFTABLE 

SETTAB 

SRVRET 

STDIO 

SUBPROC 

UVABBR 


LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 

ACCESS  PATH  TABLE 

GENERIC  CODASYL  COMMAND  TABLE 

ACCESS  PATH  INFORMATION  TABLE 

JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

CS  TO  ES  WORK  LIST  INFORMATION 

CODE  GENERATING  TABLE-  TRACKS  ALL  GENERATED 

SOFTWARE 

IISS  CDMP  CHECK  STATUS  CODES 

CONCEPTUAL  SCHEMA  ACTION  LIST 

CONCEPTUAL  SCHEMA  QUALIFY  LIST 

IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

PROCESS  ERROR  INCLUDE  FILE 

EXTERNAL  SCHEMA  ACTION  LIST 

EXTERNAL  SCHEMA  QUALIFY  LIST 

VARIABLE  DEFINITION  FOR  FILE  STATUS 

INTERNAL  SCHEMA  ACTION  LIST 

INTERNAL  SCHEMA  QUALIFY  LIST 

JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 

SUBTRANSACTIONS 

WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 
THE  RESULT  FIELD  TABLE 

LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
SUBTRANSACTION  PROCESSES  ID  TABLE 
USER  VIEW  ABBREVIATION  LIST 
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3.10.5  Whert  Include  Pile  Psed  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  nodules  documented  in  this  specification  which  include 
then.  The  purpose  of  each  nodule  is  listed  as  well. 
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PRECOMPILER  CONTROL  Where-include-f ile-used  List 

Include  Module  Module 

Pile  Mane  Purpose 


ALP ABET 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


APAT 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


APGC 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


APINFO 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


APL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


APRK 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


CKVORK 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
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PRECOMPILER  CONTROL  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CGTABLE 

CDECHK  PROVIDE  PRECOMPILER  ERROR  CHECKING 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 


CHKCDM 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDECHK  PROVIDE  PRECOMPILER  ERROR  CHECKING 

CD I GAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 
CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 

RCMOD  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 

REUSABLE 

RUMOD  SIGNAL  REUSE  OF  A  MODULE 


CSAL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
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PRECOMPILER  CONTROL  Where- i no 1 ude-f i le-used  List 

Include  Module  Module 

File  Maae  Purpose 


CSQUAL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


ERRCDH 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDECHK  PROVIDE  PRECOMPILER  ERROR  CHECKING 

CD I GAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 
CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 

MAIM  PROGRAM  NAME  NDML  MAIN  AND  UI 

RCMOD  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 

REUSABLE 

RUMOD  SIGNAL  REUSE  OF  A  MODULE 


ERRPRO 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDECHK  PROVIDE  PRECOMPILER  ERROR  CHECKING 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 
CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 
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PRECOMPILER  CONTROL  Where- i nc 1 ude-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


RCMOD  MARX  PREVIOUSLY  ASSIGNED  MODULES  AS 
REUSABLE 

RPTERR  OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP 
LISTING 

RUMOD  SIGNAL  REUSE  OF  A  MODULE 


ESAL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


ESQUAL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


FILSTAT 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 

RPTERR  OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP 
LISTING 


I  SAL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


ISQUAL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
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PRECOMPILER  OOETROL  Where- include-fi le-used  List 

Include  Module  Module 

File  Naae  Purpose 


JQGTBL 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


ORCLEDA 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDECHX  PROVIDE  PRECOMPILER  ERROR  CHECKING 

CD I GAP  CD I GAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 
CDP1S  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


RFTABLE 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


SETTAB 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


SRVRET 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


CDM01 
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PRECOMPILER  CONTROL  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CDPRE  CDPRE  MAIM  EMTRT  POINT  FOR  THE  MDML 
PRECOMPILER 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 

RCMOD  MARX  PREVIOUSLY  ASSIGNED  MODULES  AS 

REUSABLE 

RUMOD  SIGNAL  REUSE  OF  A  MODULE 


STDIO 

OPNFIL  THIS  ROUTINE  OPENS  AN  OUTPUT  FILE. 


SUBPROC 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


UVABBR 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
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3.10.6  Where  External  Routine  Osed  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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PRECOMPILER  CONTROL  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


CDFUNC 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

RCMOD  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 
REUSABLE 

RUMOD  SIGNAL  REUSE  OF  A  MODULE 


CDP10 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


CDP12 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


CDP14 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


CDPRE 1 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


CDPRE2 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


CDPRE7 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
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PRECOMPILER  CONTROL  Where-external -routine-used  List 


System 

Module 

Module 

Name 

Module 

Purpose 

CDPRE8 

CDP13 

CONTROLS  REQUEST 

PROCESSOR 

CODE 

GENERATION 

CDPRE9 

CDP13 

CONTROLS  REQUEST 

PROCESSOR 

CODE 

GENERATION 

CDQPC 

CDP13 

CONTROLS  REQUEST 

PROCESSOR 

CODE 

GENERATION 

CDQPO 

CDP13 

CONTROLS  REQUEST 

PROCESSOR 

CODE 

GENERATION 

CDQPT 

CDP13 

CONTROLS  REQUEST 

PROCESSOR 

CODE 

GENERATION 

CL S ERR 

CDPRE 

CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 

PRECOMPILER 

DELFIL 

CDECHK 

PROVIDE  PRECOMPILER  ERROR  CHECKING 

ERRPRO 
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PRECOMPILER  CONTROL  Vhere-extern&l-routine-used  List 


System  Module  Module 

Module  Name  Purpose 


APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDECHK  PROVIDE  PRECOMPILER  ERROR  CHECKING 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

CDP13  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 

RCMOD  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 

REUSABLE 

RPTERR  OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP 
LISTING 

RUMOD  SIGNAL  REUSE  OF  A  MODULE 


FOPEN 

OPNFIL  THIS  ROUTINE  OPENS  AN  OUTPUT  FILE. 


INITAL 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


INITEX 

MAIN  PROGRAM  NAME  NDML  MAIN  AND  UI 


NSEND 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

RCMOD  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 
REUSABLE 
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PRECOMPILER  CONTROL  Vhere-external -routine-used  List 

System  Module  Module 

Module  Marne  Purpose 

RUMOD  SIGNAL  REUSE  OP  A  MODULE 


OBINDN 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


OCLOSE 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


OGOM 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 

PRECOMPILER 


ODFINN 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


OEXEC 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 
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PRECOMPILER  CONTROL  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


OFETCH 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


OLOGOF 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 

PRECOMPILER 


OLON 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 

PRECOMPILER 


OOPEN 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


OPNERR 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


OPNIHPT 

CDPRE 


CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 
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PRECOMPILER  CONTROL  Where-external-rout ine-used  List 

System  Module  Module 

Module  Name  Purpose 


OROL 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 


OSQL3 

CDDGAP  DELETE  GENERATED  AP  ROWS  IN  THE  GAP 
TABLES  IN  THE  CDM 

CDIGAP  CDIGAP  INSERTS  A  ROW  IN  THE  GENERATED 

AP  TABLE. 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


PRINTF 

OPNFIL  THIS  ROUTINE  OPENS  AN  OUTPUT  FILE. 


QSEND 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 


RCV 

APNAME  INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

RCMOD  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 
REUSABLE 


REDINPT 


CDPRE 


CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 
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1  lovrabtr  1068 


PRECOMPILER  CONTROL  Where -external -routine-used  Lit! 

System  Module  Module 

Module  Meae  Purpose 


TRMXAT 

CDM01  CONTROLS  ALL  REQUESTS  FOR  MODULE  MAME8 
MAIM  PROGRAM  NAME  MDML  MAIN  AMD  UI 


UNPLINE 

CDPRE  CDPRE  MAIN  ENTRY  POINT  FOR  THE  MDML 
PRECOMPILER 


WRITERR 


CDPRE 


CDPRE  MAIN  ENTRY  POINT  FOR  THE  MDML 
PRECOMPILER 
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3.10.7  Wain  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so.  the  phrase  "well-defined 
module"  appears  by  the  module  name,  if  not  it  is  an  "external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  well. 
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PRECOMPILER  CONTROL  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CDM01 

Purpose —  >  CONTROLS 
NAMES 

ALL  REQUESTS  FOR  MODULE 

ERRPRO 

External 

routine 

INITAL 

External 

routine 

OBINDN 

External 

routine 

OCLOSE 

External 

routine 

OCOM 

External 

routine 

ODFINN 

External 

routine 

OEXEC 

External 

routine 

OFETCH 

External 

routine 

OLOGOF 

External 

routine 

OLON 

External 

routine 

OOPEN 

External 

routine 

0SQL3 

External 

routine 

QSEND 

External 

routine 

RCV 

External 

routine 

TRMNAT 

External 

routine 
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PRECOMPILER  CONTROL  Main  Program  Paris  List 


Main  Pga 

Module 

Module 

Name 

Name 

Type 

CDP13 

Purpose— » CONTROLS  REQUEST  PROCESSOR  CODE 
GENERATION 

APNAME 

Well-defined  nodule 

CDFUNC 

External 

routine 

CDP10 

External 

routine 

CDPRE7 

External 

routine 

CDPRE8 

External 

routine 

CDPRE9 

External 

routine 

CDQPC 

External 

routine 

CDQPO 

External 

routine 

CDQPT 

External 

routine 

ERRPRO 

External 

routine 

NSEND 

External 

routine 

RCV 

External 

routine 

RPTERR 

Well-defined  module 
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PRECOMPILER  CONTROL  Main  Prograa  Paris  List 


Main  Pgm 

Module 

Module 

Haste 

Name 

Type 

MAIN 

Purpose —  >  PROGRAM  NAME 

AND  01 

CDDGAP 

Well-defined  nodule 

CDECHK 

Well-defined  nodule 

CDFUNC 

External 

routine 

CD I GAP 

Well-defined  nodule 

CDP12 

External 

routine 

CDP14 

External 

routine 

CDPRE 

Well-defined  nodule 

CDPRE1 

External 

routine 

CDPRE2 

External 

routine 

CL S ERR 

External 

routine 

OELFIL 

External 

routine 

ERRPRO 

External 

routine 

INITEX 

External 

routine 

NSEND 

External 

routine 

OBINDN 

External 

routine 

OCLOSE 

External 

routine 

OCOM 

External 

routine 

OEXEC 

External 

routine 

OLOGOF 

External 

routine 

OLON 

External 

routine 

00  PEN 

External 

routine 

OPNERR 

External 

routine 

OPNINPT 

External 

routine 

OR0L 

External 

routine 

0SQL3 

External 

routine 

RCMOD 

Well-defined  nodule 

RCV 

External 

routine 

REDINPT 

External 

routine 

RPTERR 

Well-defined  nodule 

RUMOD 

Well-defined  nodule 

TRMNAT 

External 

routine 

UNPLINE 

External 

routine 

WRITERR 

External 

routine 
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PRECOMPILER  CONTROL  Main  Program  Parts  List 


Main  P gm 

Module 

Module 

Mane 

Mane 

Type 

OPMFIL 

FOPEM 

PRIMTF 

Purpose—  >THIS  ROUTINE  OPENS  AN  OUTPUT 
FILE. 

External  routine 

External  routine 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Name  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

source  code. 

LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  (I/S-l  Workbench  *C') 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program,  Subroutine,  or 

Function. 

SOURCE  FILE:  Name  of  Source  File  from  file 

specification . 

SOURCE  FILE  TYPE:  Source  File  Extension  from  file 

specification . 

HOST:  Whether  this  is  a  host -dependent 

routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

SUBSYSTEM:  IISS  sub-system  this  file  resides  in. 

SUBDIRECTORY:  Sub-directory  of  that  subsystem  in 

which  this  file  resides. 

DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 

DESCRIPTION:  A  description  of  the  module  as  otained 

from  the  source  code. 
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ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 


INCLUDE  FILES: 

ROUTINES  CALLED: 


CALLED  DIRECTLY  BY: 


A  list  of  all  the  files  that  are 
included  into  this  module  a&  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any . 

The  documented  routines  which  call 
this  module,  if  any . 


USED  IN  MAIN  PROGRAM(S) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE: 


LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST : 


APNAME 

INTERFACES  WITH  THE  MODULE  NAME  QUEUE 
SERVER 

VAX- 11  COBOL 
SUBROUTINE 
APNAME 
.COB 


SUBSYSTEM:  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41200 


DESCRIPTION: 


THE  PURPOSE  OF  THIS  ROUTINE  IS  TO  ACT  AS  A 
GENERALIZED  INTERFACE  TO  THE  MODULE  NAME 
QUEUE  SERVER.  IT  WILL  GET  NEW  NAMES. 

MOD  2.0  STANDARDIZED  ERROR  HANDLING. 


ARGUMENTS : 


DBMS -NAME  -  DSPLY  [X(30>] 
AP-NAME  -  DSPLY  [X(10)] 
RET -STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


SRVRET 
ERR CDM 
CHKCDM 
ERR PRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
IISS  CDMP  CHECK  STATUS  CODES 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CDFUNC 

NSEND 
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RCV 

ERRPRO 

CALLED  DIRECTLY  BY: 

CDP13  -  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 

USED  IN  MAIN  PROGRAM(S): 

CDP13  -  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


CDDGAP 

DELETE  GENERATED  AP  ROWS  IN  THE  GAP 

TABLES  IN  THE  CDM 

VAX- 11  COBOL 

SUBROUTINE 

CDDGAP 

.COB 


CDM 

PS41200 


DESCRIPTION: 


PERFORM  SQL  DELETE  STATEMENT  TO  DELETE  GENERATED  AP 

REFERENCES 

BASED  ON  TttE  NAME  OF  THE  USER  MODULE  SUCEESSFULLY 

RE-PRECOMPILED 


ARGUMENTS : 


USER-MOD-ID  -  DSPLY  [X(10)3 
ORACLE -LDA  -  RECRD 
RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


ERRCDM 

CHKCDM 

ORCLEDA 

ERRPRO 


IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
IISS  CDMP  CHECK  STATUS  CODES 
VS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


OOPEN 

0SQL3 

OBINDN 
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OEXEC 

OCLOSE 

ERRPRO 

CALLED  DIRECTLY  BY: 

CDECHK  -  PROVIDE  PRECOMPILER  ERROR  CHECKING 
USED  IN  MAIN  PROGRAM(S): 

MAIN  -  PROGRAM  NAME  NDML  MAIN  AND  UI 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME :  CDECHX 

PURPOSE:  PROVIDE  PRECOMPILER  ERROR  CHECKING 

LANGUAGE :  VAX- 1 1  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  CDECHX 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41200 
DESCRIPTION: 


THIS  ROUTINE  WILL  TEST  THE  RET-STATUS  AT  END  OF 
PRECOMPILING  ONE  USER  MODULE.  IF  GOOD  THEN 
RCMOD  WILL  BE  CALLED  TO  MARK  ALL  SOFTWARE  MODULES 
PREVIOUSLY  ASSOCIATED  WITH  THE  USER  ROUTINE  AS 
INACTIVE.  THE  DELETE  ALL  OLD  GENERATED  AP  REFERENCES 
AND  FINALLY.  INSERT  ALL  NEW  GENERATED  AP  REFERENCES. 
IF  THE  PRECOMPILE  WAS  UNSUCCESSFUL.  THEN  EACH 
MODULE  NEWLY  ASSOCIATED  WITH  THE  USER  MODULE  MUST  BE 
MARKED  AS  AVAILABLE  FOR  REUSE  BY  CALLING  RUMOD  AND 
THE  FILES  CONTAINING  GENERATED  CODE  DELETED. 


o 


ARGUMENTS : 


PREC-STATUS  -  DSPLY  [X(5)] 
LAST-CGT-USED  -  DSPLY  [S9(9)] 
USER -MOD- ID  -  DSPLY  tX(10)] 
MY-HOST  -  DSPLY  [XXX] 
TARGET-HOST  -  DSPLY  [XXX] 

PARCL1  -  DSPLY  [X(30)] 

PARCL2  -  DSPLY  [X(30)] 

PARCL3  -  DSPLY  [X(30)] 

PARCL4  -  DSPLY  [X(30)3 
SOURCE -LANGUAGE  -  DSPLY  [X(10>] 
CODE -GENERATOR -TABLE  -  RECRD 
ORACLE -LD A  -  RECRD 
RET-STATUS  -  DSPLY  [X( 5)] 
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INCLUDE  FILES: 


ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

CHKCDM  -  IISS  CDMP  CHECK  STATUS  CODES 

CGTABLE  -  CODE  GENERATING  TABLE-  TRACKS  ALL  GENERATED 

SOFTWARE 

ORCLEDA  -  WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


ERRPRO 

RCMOD  -  MARK  PREVIOUSLY  ASSIGNED  MODULES  AS  REUSABLE 

CDDGAP  -  DELETE  GENERATED  AP  ROWS  IN  THE  GAP  TABLES  IN 

THE  CDM 

CDIGAP  -  CD I GAP  INSERTS  A  ROW  IN  THE  GENERATED  AP 

TABLE . 

DELFIL 

RUMOD  -  SIGNAL  REUSE  OF  A  MODULE 


CALLED  DIRECTLY  BY: 


CDPRE  -  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 

PRECOMPILER 


USED  IN  MAIN  PROGRAM(S) : 


MAIN  -  PROGRAM  NAME  NDML  MAIN  AND  UI 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CD I GAP 

CD I GAP  INSERTS  A  ROW  IN  THE 

GENERATED  AP  TABLE. 

VAX-11  COBOL 
SUBROUTINE 
CD  I  GAP 
.COB 


SUBSYSTEM:  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41200 


DESCRIPTION: 


PERFORM  SQL  INSERT  STATEMENT  TO  INSERT  A  SINGLE  TUPLE  INTO 

THE 

GENERATED  AP  TABLE. 


ARGUMENTS : 


GENERATED-MOD- ID  -  DSPLY  [1(10)1 
USER -MOD-ID  -  DSPLY  [X(10)l 
GENERATED-BY  -  DSPLY  [X(10)l 
DB-ID  -  DSPLY  [80(0)1 
MOD-TYPE  -  DSPLY  [X(10)l 
CASE-NO  -  DSPLY  [80(0)1 
IS-ACTION  -  DSPLY  [X] 

ORACLE -LDA  -  RE CRD 

RET -STATUS  -  DSPLY  [X(5)l 


INCLUDE  FILES: 


ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
CHECDM  -  IISS  CDMP  CHECK  STATUS  CODES 
ORCLSDA  -  VS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA  . 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


PS  620141200 
1  November  1985 


warms  called: 


OOPEN 

0SQL3 

OBINDN 

OEXKC 

OCLOSE 

ERRPRO 


CALLED  DIRECTLY  BY: 

CDECHK  -  PROVIDE  PRECOMPILER 

USED  IV  MAIM  PROGRAM(S): 

HAIR  -  PROGRAM  VAME 


ERROR  CHECKING 


NDML  MAIN  AND  UI 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  PILE: 
SOURCE  FILE  TYPE: 
HOST: 


CDM01 

CONTROLS  ALL  REQUESTS  FOR  MODULE  NAMES 

VAX- 11  COBOL 

PROGRAM 

CDM01 


.COB 


SUBSYSTEM:  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41200 


DESCRIPTION: 


THIS  ROUTINE  IS  A  MAIN  PROGRAM  Q-SERVER. 

IT  WILL  HANDLE  4  TYPES  OF  REQUESTS: 

QO  -  PROVIDE  A  NEV  UNUSED  NAME  FOR  A  SOFTWARE  MODULE. 

PD  -  PROVIDE  A  NAME  FOR  A  SOFTWARE  MODULE  FROM  A  LIST 
OF  PREDETERMINED  NAMES. 

RM  -  MARK  A  SINGLE  MODULE  NAMEAS  AVAILABLE  FOR  REUSE 
RA  -  MARK  ALL  NAMES  ASSOCIATED  WITH  A  USER  MODULE  NAME 
(THROUGH  PREVIOUSLY  BEING  GENERATED)  AS  BEING  AVAILABLE 
FOR  REUSE. 

NOTE  LIMITATIONS  SECTION  > ! 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

SRVRET 

ORCLEDA 

ALFABET 

ERRPRO 


IISS  CDMP  CHECK  STATUS  CODES 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 
LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


TRMNAT 
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INITAL 

OLON 

OLOGOF 

OOPEN 

OCLOSE 

OSQL3 

ODFINN 

RCV 

OEXEC 

OFETCH 

OBINDN 

OCOM 

QSEND 

ERRPRO 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST : 


CDP13 

CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 

VAX- 11  COBOL 

SUBROUTINE 

CDP13 


.COB 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41200 


DESCRIPTION: 


-  CDP13  IS  CALLED  FOR  EACH  CONCEPTUAL 
TRANSACTION  AFTER  THE  CS-IS  TRANSFORM 
DONE  BY  CDPRE6  IS  COMPLETE. 

IT  PROCESSES  THE  SUBTRANSACTIONS 
IDENTIFIED  BY  THE  CS  TO  IS  DECOMPOSER , 
DETERMINING  WHICH  DBMS  EACH  SUBTRAHS 
APPLIES  TO,  AND  TAXING  THE  APPROPRIATE 
ACTION  FOR  EACH. 


ARGUMENTS : 


SUBTRANS -PROCESS - ID-TABLE  -  RE CRD 
IS-ACTION-LIST  -  RE CRD 
IS-QUALIFY-LIST  -  RE CRD 
ES -ACTION -LI ST  -  RECRD 
ES -QUALIFY -LI ST  -  RECRD 
CS -ACTION-LIST  -  RECRD 
CE -WORK -LI ST  -  RECRD 
UV-ABBR-LIST  -  RECRD 
CS-QUALIFY-LIST  -  RECRD 
JQG  -  RECRD 

JQG-ATTR I BUTE -PAIR-LIST  -  RECRD 

SET-TABLE  «  RECRD 

RFT  -  RECRD 

MY-HOST  -  DSPLY  [XXX] 

TARGET-HOST  -  DSPLY  [XXX] 

ORACLE -LDA  -  RECRD 
PARCL1  -  DSPLY  [X(30)J 
PARCL2  -  DSPLY  [X(30>] 
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PARCLS  -  DSPLY  [X(30)l 
PARCL4  -  DSPLY  [X(30)] 

ERRFILE  -  DSPLY  [X(30)] 

SOURCE - LANGUAGE  -  DSPLY  [X(10>] 
IOSECTION- INDICATOR  -  DSPLY  [9] 
CODE-GENERATOR-TABLE  -  RE CRD 
RET -STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

APAT 

APINFO 

APRK 

APGC 

SUBPROC 

I  SAL 

ISQUAL 

CSQUAL 

JQGTBL 


SETTAB 

RFTABLE 

ESAL 

ESQUAL 

CEVORK 

UVABBR 

CSAL 

CGTABLE 

ORCLEDA 

ERRPRO 


-  IISS  CDMP  CHECK  STATUS  CODES 

-  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

-  ACCESS  PATH  TABLE 

-  ACCESS  PATH  INFORMATION  TABLE 

-  TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

-  GENERIC  CODASYL  COMMAND  TABLE 

-  SUBTRANSACTION  PROCESSES  ID  TABLE 

-  INTERNAL  SCHEMA  ACTION  LIST 

-  INTERNAL  SCHEMA  QUALIFY  LIST 

-  CONCEPTUAL  SCHEMA  QUALIFY  LIST 

-  JOIN  QUERY  GRAPH  TELLS  HOW  TO  CONNECT 

SUBTRANSACTIONS 

-  JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

-  LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 

-  THE  RESULT  FIELD  TABLE 

-  EXTERNAL  SCHEMA  ACTION  LIST 

-  EXTERNAL  SCHEMA  QUALIFY  LIST 

-  CS  TO  ES  WORK  LIST  INFORMATION 

-  USER  VIEW  ABBREVIATION  LIST 

-  CONCEPTUAL  SCHEMA  ACTION  LIST 

-  CODE  GENERATING  TABLE-  TRACKS  ALL  GENERATED 

SOFTWARE 

-  WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

-  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


APNAME  -  INTERFACES  WITH  THE  MODULE  NAME  QUEUE  SERVER 

CDPRE8 

CDP10 

RPTERR  -  OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP  LISTING 

CDQPO 

CDQPC 

CDQPT 

CDPRE7 
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CDPRE9 

ERRPRO 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


CDPRE 

CDPRE  MAIN  ENTRY 

PRECOMPILER 

VAX- 11  COBOL 

SUBROUTINE 

CDPRE 

.COB 

CDM 

PS41200 


POINT  FOR  THE  NDML 


-  THIS  IS  THE  MAIN  ENTRY  POINT  FOR  THE  NDML  PRECOMPILER 
ON  INPUT  THE  USER  INTERFACE  HAS  BEEN  PERFORMED.  IT 
CALLS  CDPRE 1  TO  BREAK  APART  THE  USER'S 
SOFTWARE  MODULE  INTO  THE  FOUR  PARCELS ,  THEN  CALLS 


ARGUMENTS : 


AP-FILE-IN  -  DSPLY  (X(30)] 
ERROR-FILE  -  DSPLY  tX(30)] 

AP -TARGET -HOST  -  DSPLY  [XXX] 
USER-AP-NAME  -  DSPLY  [X(10)] 
CODE -GENERATOR -TABLE  -  RECRD 
GOOD-PRECOMPILES  >  DSPLY  [S9(9)] 
BAD-PRECOMPILES  -  DSPLY  [S9(9)] 
RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


ORCLEDA 

SRVRET 

CHKCDM 

ERRCDM 

CGTABLE 

ERRPRO 


WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
IISS  CDMP  CHECK  STATUS  CODES 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
CODE  GENERATING  TABLE-  TRACKS  ALL  GENERATED 
SOFTWARE 

PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 


OLON 

OPNINPT 

RPTERR  -  OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP  LISTING 

CDPRE1 

CDPRE2 

CDP12 

CDP14 

OCOM 

OLOGOF 

ERRPRO 

OROL 

CDECHK  -  PROVIDE  PRECOMPILER  ERROR  CHECKING 

OPNERR 

WRITERR 

REDINPT 

UNPLINE 

CLSERR 


CALLED  DIRECTLY  BY: 

MAIN  -  PROGRAM  NAME  NDML  MAIN  AND  UI 

USED  IN  MAIN  PROGRAM(S) : 

MAIN  -  PROGRAM  NAME  NDML  MAIM  AND  UI 


PS  620141200 
1  November  1985 


PRECOMPILER  CONTROL  Module  Docunentat i on 


NAME: 

MAIN 

PURPOSE: 

PROGRAM  NAME 

NDML  MAIN  AND  UI 

LANGUAGE: 

VAX- 11  COBOL 

MODULE  TYPE: 

PROGRAM 

SOURCE  FILE: 

MAIN 

DESCRIPTION: 


INCLUDE  FILES: 


FILSTAT 
ERRCDM 
CHKCDM 
SRVRET 
COT  ABLE 

ERRPRO 


-  VARIABLE  DEFINITION  FOR  FILE  STATUS 

-  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

-  IISS  CDMP  CHECK  STATUS  CODES 

-  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

-  CODE  GENERATING  TABLE-  TRACKS  ALL  GENERATED 

SOFTWARE 

-  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CDPRE 

TRMNAT 

ERRPRO 

INITEX 


-  CDPRE  MAIN  ENTRY  POINT  FOR  THE  NDML 
PRECOMPILER 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


OPNFIL 

THIS  ROUTINE  OPENS  AN  OUTPUT  FILE. 
C 

FUNCTION 
I  NT  () 

OPNFIL 

.C 

CDM 

PS41200 


DESCRIPTION: 


SYNOPSIS 

C 

COBOL 

FORTRAN 


0PNFIL(8FILE_NAME)  ; 

CALL  "OPNFIL"  USING 

FILE-NAME. 

CALL  OPNFIL( FILENAME) 


INPUT: 

CHAR  *FILE_NAME  ; 
OUTPUT: 


DESCRPIPTION: 

THE  FILE  WILL  CONTAINS  THE  USER'S  NDDL. 

ARGUMENTS : 

FILENAME  -  CHAR  • 

INCLUDE  FILES: 

8TDI0  -  *•••  PURPOSE  HOT  FOUND  BY  STRIPPER  •••• 

ROUTINES  CALLED: 


PS  620141200 
1  November  1985 


FOPEN 

PRIMTF 


PS  620141200 
1  November  1985 


PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 


RCMOD 

MARK  PREVIOUSLY  ASSIGNED  MODULES  AS 

REUSABLE 

VAX- 11  COBOL 

SUBROUTINE 

RCMOD 

.COB 


HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41200 


DESCRIPTION: 


THIS  ROUTINE  MUST  BE  USED  TO  MARK  ALL  PREVIOUSLY 
ASSIGNED  MODULES  GENERATED  FOR  THE  USER  MODULE  NAME 
AS  REUSEABLE.  IT  EXPECTS  THE  NAME  OF  A  USER  MODULE. 


ARGUMENTS : 


USER-MOD-NAME  -  DSPLY  [X(10)] 
RET- STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


SRVRET 

ERRCDM 

CHKCDM 

ERRPRO 


AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
IISS  CDMP  CHECK  STATUS  CODES 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CDFUNC 

NSEND 

RCV 

ERRPRO 


CALLED  DIRECTLY  BY: 


PS  620141200 
1  November  1985 


CDECHX  -  PROVIDE  PRECOMPILER  ERROR  CHECK I MG 
USED  IH  MAIM  PROGRAM(S) : 

MAIM  -  PROGRAM  MAME  MDML  MAIM  AMD  UI 
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PRECOMPILER  CONTROL  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  PILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


RPTERR 

OUTPUT  PRECOMPILER  ERROR  MESSAGES  TO  AP 

LISTING 

VAX- 11  COBOL 

SUBROUTINE 

RPTERR 

.COB 

CDM 

PS41200 


THIS  PROGRAM  OUTPUTS  ERROR  MESSAGES  TO  AP 
LISTING  FROM  PRECOMPILER-ENCOUNTERED  ERRORS. 
THIS  ROUTINE  SIMPLY  OPENS  THE  LISTING  AT  END, 
WRITES  THE  MESSAGE  AND  CLOSES  THE  LISTING. 


ARGUMENTS: 


rWAKE  •  DSPLY  [XCSO)] 
ERRMESS  -  DSPLY  (X(60)] 


INCLUDE  FILES: 


FIL8TAT  -  VARIABLE  DEFINITION  FOR  FILE  STATUS 
ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 

ERRPRO 


CALLED  DIRECTLY  BY: 

CDP13  -  CONTROLS  REQUEST  PROCESSOR  CODE  GENERATION 


PS  620141200 
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CDP1E  -  CDPRE  HAIM  KMTtT  POIVT  POM  THE  MOHL 

PMCOOHPILSM 


USED  IM  HAIM  PHOGRAM(S): 


CDP13  -  OOMTHOLS  REQUEST  PROCESSOR  CODE  GEMERATIOM 

MAIM  -  PROGRAM  MAKE  MOHL  HAIM  AMD  UI 
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PRECOMPILER  CONTROL  Module  Docusontat i on 


■AMS: 

POMPOM: 

LAMOAGC’ 

MOOOLK  TTPC: 
SOURCE  FILM: 
SOURCE  PILE  TTPI: 


RUNOD 

SIQSAL  MUSE  OF  A  MODULE 
VAX- 11  COBOL 
SUBROUTINE 


COB 


SUBSYSTEM :  COM 

SUBDIRECTORY : 

DOCUMEVTAT  XOM  GROUP:  PS41200 


DESCRX  PTXOM : 


THIS  BOOTXME  MUST  BE  USED  TO  MABS  A  SXBOLE 
MODULE  BANE  AS  AVAILABLE  FOB  REUSE.  XT  VILL 
SEMD  A  MESSAGE  TO  THE  NODULE  NAME  Q- SERVER 


ARGUMENTS: 


DBMS-SAME  •  DSPLT  (1(10)) 
AP-MANE  -  DSPLT  (1(10)] 
BET-STATUS  -  DSPLT  (1(B)) 


ISCLUDE  FILES: 


SRVBET  -  AS  TNE  RETUBS  GIVES  A  TABLE-FULL  ERROR 

EBRCDH  -  IXSS  ERROR  STATUS  CODES  FOR  COMP  NODULES 

CHECOM  -  IISS  COMP  CMSC1  STATUS  CODES 
ERRPBO  -  PROCESS  ERROR  ISCLUDE  FILE 


ROUTISES  CALLED: 


CDFUSC 

■SEMD 

ERRPBO 


CALLED  DIRECTLT  ST: 

CDECMX  -  PROVIDE  PRECOMPILER  ERROR  CHECK I SG 
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USED  IK  HAIM  PROGRAM(S): 

HAIM  -  PROGRAM  MAKE  MDHL  MAIM  AMD  UI 


PS  620141200 
1  luvwbir  1068 


PRECOMPILER  CONTROL  Module  Documentation 


MAMS: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 

SOURCE  PILE: 

SOURCE  PILE  TYPE: 
HOST: 

8US8YSTSM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


STRMOV 

MOVE  THE  STRING  TO  THE  POOL 

VAX-1 1  FORTRAN 

SUBROUTINE 

STRMOV 

.FOR 

COM 

P841200 


DESCRIPTION: 


ARGUMENTS: 


STRING  -  CHAR 
POOL  •  CHAR 
SISE  -  1*4 

■CHAR  -  1*4 
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PRECOMPILER  OOrmOL  Module  Docuacnt&t i on 


HAMS: 

POMPOM : 

LANGUAGE: 

MODULE  TYPE: 

•OUNCE  PILE: 

•OUNCE  PILE  TYPE: 
HOST: 

SUSSYSTEM: 

SOSDIMECTOMY: 
DOCUMENTATION  OMOOP: 

DKSCNXPTXON : 


ANOUMEHTB: 

I  CLAUS  -  CHAM 


8UBM0V 

FACILITATE  A  SUB-STRING  HOVE 

VA1-11  FORTRAN 

SUBROUTINE 

SUBNOV 

.POM 

COM 

P 841200 


•  o 
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9.10.9  Inolude  rile  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
aoh  include  file  listed  in  3.10.4  as  specified  in  the  souroe 
ode.  The  language  it  is  written  in  is  also  given. 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  ALT ABET 

PURPOSE:  LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION : 


THIS  IS  THE  ENGLISH  ALPHABET.  THE  LETTERS  ARE  USED 
FOR  ASSIGNING  THE  NEXT  UNIQUE  NAME  WHEN  THE 
NUMBERS  RUN  OUT. 


ALP ABET. INC 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  APAT 

PURPOSE:  ACCESS  PATH  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  THE  ACCESS  PATH  FOR  ONE  SUBTRANSACTIOM 
FOR  A  NDML  REQUEST. 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  APGC 

PURPOSE:  GENERIC  CODASYL  COMMAND  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


HOLDS  THE  GENERIC  CODASYL  DHL  COMMANDS  FOR  AN 
ACCESS  PATH  OF  A  NDML  REQUEST 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  APINFO 

PURPOSE:  ACCESS  PATH  INFORMATION  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  IS  A  COLLECTION  OF  INFORMATION  STORED  IN  A 

NUMBER  OF  VARIOUS  TABLES  USED  BY  THE  ACCESS  PATH  TABLE 
AND  THE  GENERIC  CODASYL  TABLE.  SEE  CDMP  SPEC.  PRE6 


APINFO. INC 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  APL 

PURPOSE:  JOIN  QUERY  ATTRIBUTE  PAIR  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  ABOUT  THE  JOIN 
ATTRIBUTES  FOR  NDKL  SUBTRANSACT IONS 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  APRK 

PURPOSE:  TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  FOR  THE  KEYS  OF 
RECORDS  CONTAINED  IN  THE  CURRENT  ACCESS 
PATH 


PRECOMPILER  CONTROL  Iaclvd*  film  Descript t 


FILE  NAME:  CEVORK 

PURPOSE:  CS  TO  ES  WORK  LIST  INFORMATION 

LANGUAGE :  VAX- 11  COBOL 

DESCRIPTION: 


Ft  630141300 
1  lovMbtr  1065 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE 
CDMP  MODULES 


PS  630141800 
1  November  IMS 


PRECOMPILER  CONTROL  Include  Pile  Description 


PILE  NAME:  CSAL 

PURPOSE:  CONCEPTUAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


TABLE  TO  HOLD  CONCEPTUAL  DATA  ABOUT  THE  REQUEST 
THE  CONCEPTUAL  SCHEMA  ACTION  LIST 


PS  630141200 
1  November  1085 


PRECOMPILER  CONTROL  Include  Pile  Description 


PILE  MAKE:  CSQUAL 

PURPOSE:  CONCEPTUAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  FOR 
THE  REQUESTS  QUALIFICATION 


THE  CONCEPTUAL  SCHEMA  QUALIFY  LIST 
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PRECOMPILER  CONTROL  Inolude  File  Description 


PILE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP 
MODULES  FOR  ERROR  HANDLING 


PS  630141300 
1  November  1068 


FMOOMP1LKR  CONTROL  I no lode  Pilt  Description 


PILE  MANX:  ERR PRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  PILE 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 
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PR  630141800 
1  November  1MB 


PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  ESAL 

PURPOSE:  EXTERNAL  SCHEMA  ACTION  LIST 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


CONTAINS  THE  EXTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  REQUEST 


THE  EXTERNAL  SCHEMA  ACTION  LIST 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  ESQOAL 

PURPOSE:  EXTERNAL  SCHEMA  QUALIFY  LIST 

LANGUAGE :  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  EXTERNAL  SCHEMA  INFORMATION  FOR  THE  NDML 
QUALIFICATION 


THE  EXTERNAL  SCHEMA  QUALIFY  LIST 


•  i 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  FILSTAT 

PURPOSE:  VARIABLE  DEFINITION  FOR  FILE  STATUS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


FILE  USAGE  FILE  STATUS  PARAMETER 


FILSTAT 

FILE  USAGE  FILE  STATUS  PARAMETER 

SIZE  AND  THE  88  VALUE  ARE  PROBABLY  MACHINE 
DEPENDENT 

(THIS  IS  FOR  VAX-11  COBOL) 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  ISAL 

PURPOSE:  INTERNAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION : 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  ABOUT  AN 
NDML  REQUEST 

THE  INTERNAL  SCHEMA  ACTION  LIST 


PS  620141200 
1  Me  member  1085 


PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  ISQUAL 

PURPOSE:  INTERNAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  QULIFICATIOM 


THE  INTERNAL  SCHEMA  QUALIFY  LIST 


PS  620141200 
1  November  1985 


PRECOMPILER  OOMTROL  Include  File  Description 


FILE  RAMS:  JQGTBL 

PURPOSE:  JOIN  QUERY  GRAPH  TELLS  BOV  TO  CORRECT 

SUBTRAHSACT10HS 
LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION : 


PS  620141200 
1  November  1985 


PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  ORCLEDA 

PURPOSE:  VS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


THE  ORACLE  LOGON  DATA  AREA 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  RFTABLE 

PURPOSE:  THE  RESULT  FIELD  TABLE 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  CONCEPTUAL  SCHEMA  INFORMATION  ABOUT 
THE  RESULTS  OF  AN  NDML  REQUEST 


THE  RESULT  FIELD  TABLE 

WHEN  CHANGING  THE  STRUCTURE  OF  THIS  TABLE 
BE  SURE  TO  CHANGE  THE  LAYOUT  IN  THE 


i 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  SETTAB 

PURPOSE:  LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


SET  TABLE  TO  KEEP  TRACK  OF  CODASYL  NDML  REQUESTS 
IN  TERMS  OF  OWNER  AND  MEMBER  RELATIONSHIPS 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  flET-CODE-5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC 
SRV- SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY -NOT -FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 

MODIFIED  20  AUG  84  INITALIZE  ALL  LOCAL  VARAIBLES  TO 
SPACES  OR  0. 

MODIFIED  5/21/85  TO  ADD  RCL  AND  FILGEN  RETURN  CODES 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  SUBPROC 

PURPOSE:  SUBTRANSACTION  PROCESSES  ID  TABLE 

LANGUAGE :  VAX-1 1  COBOL 

DESCRIPTION: 


THIS  TABLE  MUST  HAVE  THE  SAME  NUMBER  OF  OCCURS 
AS  THE  RITABLE . INC  SINCE  THEY  ARE  PARALLEL 
TABLES . 
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PRECOMPILER  CONTROL  Include  File  Description 


FILE  NAME:  UVABBR 

PURPOSE:  USER  VIEV  ABBREVIATION  LIST 

LANGUAGE:  VAX-11  COBOL 

DESCRIPTION: 


CONTAINS  THE  ABBREVIATIONS  FOR  ALL  USER 
VIEV  REFERENCED  IN  THE  NDML  REQUEST 


PS  620141200 
1  November  1985 


3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  nodules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4-1  Introduction  and  Definitions 


"Testing"  is  a  systematic  process  that  nay  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  nay  be 
defined  in  advance,  and  a  sequence  of  test  steps  nay  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  then  nore  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  nuch  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed. 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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